PowerFrax is a fractal generator used to demonstrate DayStar's accelerators and multiprocessing systems. The version that is included in this SDK takes advantage of the Multiprocessing API Library. Source code has been provided that demonstrates how this is achieved.
This document describes the components of PowerFrax, how PowerFrax works, how to build PowerFrax and how to debug it. For specific implementation details refer to the comments within the source code itself.
PowerFrax Components
PowerFraxMP.π CW P3
This Metrowerks PPC project builds a PPC code resource directly into the "PowerFrax" application. This is the module that implements all of the multiprocessing facilities. Note that the Multiprocessing API Library is 'weak-linked' into this project. Any application that does not require the library to be present should weak link to the library. The Mac OS will refuse to launch any program that strong links to a shared library that cannot be located.
MandelbrotPPCMod.π CW P3
This Metrowerks PPC project builds a PPC code resource directly into the "PowerFrax" application. This is the module that implements the Mandelbrot algorithm. This project is provided as a reference. It is not really necessary to understand the multiprocessing example.
sources
This folder contains the source files used by the projects.
"HFMultiprocessingPPC.c" is part of the "PowerFraxMP.π CW P3" project. It contains the functions that PowerFrax uses for task creation, communication and destruction. It also contains the single function used for the tasks.
"PowerFraxMP.π.exp" is part of the "PowerFraxMP.π CW P3" project. It lists the symbols exported from the module to PowerFrax.
"HFDocMandelbrot.c" is part of the "MandelbrotPPCMod.π CW P3" project. It contains a generic Mandelbrot fractal generation routine
"HFDocMandelbrot.o" is a highly optimized compiled version of "HFDocMandelbrot.c". It was compiled using the Motorola compiler which for this particular piece of code proved to be significantly better than anything else. For better performance in PowerFrax include this file directly in the "MandelbrotPPCMod.π CW P3" project, remove the file "HFDocMandelbrot.c" and recompile. The version of PowerFrax in the SDK was built using this optimised file.
includes
This folder contains the include files used by the projects.
"HFDocMandelbrot.h" is part of the "MandelbrotPPCMod.π CW P3" project. It defines the parameter block used by the Mandelbrot function.
PowerFrax
The main PowerFrax application. "PowerFraxMP.π CW P3" and "MandelbrotPPCMod.π CW P3" both build directly into this file.
3D Projection
A PowerFrax plug-in that will generate 3D projections of fractals. QD3D and a PowerPC Macintosh are required to use this plug-in. 3D projections may not be available under some versions of QD3D.
Julia Sets
A PowerFrax plug-in that will generate Julia sets.
Fractals
Some cool fractals.
PowerFrax Read Me
The read me that went out with the release version of PowerFrax.
How PowerFrax Works
PowerFrax is a 68k application that uses PPC code fragments for multiprocessor support and for fractal generation. When PowerFrax starts it initializes multiprocessing by calling fMPInitialize() inside the PowerFraxMP module built by "PowerFraxMP.π CW P3". To create the required tasks fMPTasksCreate() is called. When PowerFrax is through with the tasks it calls fMPTasksQuit(). PowerFrax generates fractals one scanline at time. It submits one scanline to each of the tasks currently available by calling fMPTaskRun() for each task. It then waits for each task to finish by calling fMPTaskWait(). This process is repeated until the fractal is finished.
The number of tasks available to PowerFrax can be controlled via the Multiprocessing menu. A multi-processor environment can be simulated by pressing command-d. The contents of the Multiprocessing menu will convert to 'DayStar' mode. Select the 'Other...' item and type in a number from 1 to 100. That many tasks will be created and used to regenerate all the open fractals.
Since PowerFrax can support plugin based fractal generators the PowerFraxMP module allows an arbitrary fractal generating function to be specified. Thus when examining the task code inside "HFMultiprocessingPPC.c" no reference to a specific fractal generator will be found. The statement
p->workFunction( p->params );
is the call to the function that generates the fractal data. Parameters passed to the function fMPTaskRun() define which function will be used and what parameters will be used prior to signaling the task to run. Note that the parameters referred to by tasks are unique blocks of data. If a shared block were used then the tasks would all generate the same information.
The project "MandelbrotPPCMod.π CW P3" creates the Mandelbrot fractal generating module. The one and only function inside this project is the one called by fTask() using the above statement. There is a similar function inside the Julia Sets plug-in.
Building And Debugging PowerFrax
PowerFrax comes pre-built. It is not necessary to recompile anything unless you want to experiment with debugging.
CodeWarrior Pro 3:
Open "PowerFraxMP.π CW P3" and select "Enable Debugger" from the "Project" menu followed by "Debug" from the "Project" menu. The multi-processing module will be built directly into the PowerFrax application, PowerFrax will be launched and the integrated debugger will be activated.
Multiprocessing Support
Please see the last entry in "MP API FAQs" for support information.
Historical note: PowerFrax' first name was HappyFracs; a name which lasted about two days, i.e. the interval between starting it and Monday morning, when Marketing first saw it. Although the product's name has changed, most of the naming conventions used in the project are still based on the earlier name.
